Single Wire Output Logger (SWOL) Users Guide
Table of Contents
Single Wire Output Logger (SWOL)
SWOL is an ecosystem to provide extensive, flexible, yet minimally invasive debug information using the ARM ITM module on Texas Instruments (TI) CC13x2 / CC26xx devices. The debug information is then parsed with Python and outputted / viewed using Wireshark.
Overview
The ecosystem consists of the following parts, which are expanded upon in sections below:
- SWO Driver: An embedded driver to send various debug output (formatted text, data dumps, etc) through a single-wire serial interface. For documentation on this, see the Doxygen only after completing the Quick-Start demo here
- Logger: Python code to parse .elf file, receive and parse seral data, build into high-level frames, and send to Wireshark. For documentation on this, see TODO
- A basic Wireshark dissector to display frames and timing in Wireshark
- Gandelf: A GUI configuration tool (Gandelf) provided as an executable to set input files, settings, and manage the pipe between Python and Wireshark.
Environment Setup
These instructions will detail how to get a SWOL Test project running on your local machine for development and testing purposes.
Currently, this has only been tested on Windows 10. It theoretically should work on all operating systems but you are on your own to verify this. There are most likely bugs. Testing for other operating systems is planned for future work.
Hardware Prerequisites
- A development board that includes XDS-110 such as the CC26X2R Launchpad. Ensure that the SWO jumper is attached: